home *** CD-ROM | disk | FTP | other *** search
/ MacTech 1 to 12 / MacTech-vol-1-12.toast / Tools / Bare Bones PopupFuncs 2.8.2 / About MPW Technicolor next >
Text File  |  1996-03-16  |  6KB  |  174 lines
  1. MPW Technicolour 0.9.6
  2. Copyright 1995-1996 Chris K. Thomas.  All Rights Reserved.
  3. <ckt@best.com>
  4.  
  5. "It's flowing through my brain
  6.  and it’s easing all my pain."
  7.  
  8. MPW Technicolor is an easily-installed patch to MPW which
  9. provides simple PowerMac-and-68k-native syntax coloring.
  10.  
  11. New in version 0.9.6:
  12.     * Fixed a cosmetic bug.
  13.     * Some minor additions for SOM.
  14.     * Forgot the "inline" keyword.
  15.     * I seem to keep losing the keyword color array resource
  16.       ('kJai' 128).  It's back in this version.  Thanks to
  17.       all those who reported the loss.
  18.     
  19. New in version 0.9.5:
  20.     * New and updated keyword sets:  Perl, PPCAsm, SOM IDL,
  21.       and Java.
  22.     * Stability.  Shouldn’t cause crashes.
  23.     * Speed.  Should be significantly faster than previous
  24.       releases.
  25.  
  26. This will probably be the last significant release of MPW
  27. Technicolor in hack form.
  28.  
  29. MPW Technicolour 0.9 features:
  30.    * CodeWarrior-style keyword colorizing
  31.    * configurable, resource-based keyword sets
  32.    * Out-of-the-box support for:
  33.      - C
  34.      - C++
  35.      - Fortran
  36.      - Java
  37.      - Inform
  38.      - Pascal
  39.      - Perl
  40.      - PPCAsm
  41.      - Rez
  42.      - SOM IDL
  43.  
  44.    * runs in BBEdit, Think C, Think Pascal, and probably any others.
  45.  
  46. I’m at ckt@best.com.  Suggestions, bug reports, and other friendly
  47. correspondence welcome.  Send in your keyword resources or Rez
  48. sources for inclusion in the next distribution.
  49.  
  50. Technique used is directly inspired by "ColorHack 1991", written in
  51. 68k assembly by Ray Sanders and Steve Antonakes at MacHack 1991.
  52.  
  53. Thanks to: (chronological order)
  54.  
  55. Chris Reed
  56. Michael S. Kluskens
  57. Peter Terhoeven
  58. Steve Jasik
  59. Rich Siegel
  60. Matt Mora
  61. Alex McKale
  62. Eric Schlegal (sp?)
  63.  
  64. —————————————• Installation
  65. "You can’t afford to pass him by."
  66.  
  67. Simply copy the resources from the MPW Technicolor file into
  68. the application you wish to Technicolorize (probably MPW or
  69. BBEdit or CodeWarrior.)
  70.  
  71. If you use a version of PopUpFuncs prior to 2.7:  There is an
  72. existing ‘WDEF’ id 0 in your MPW Shell.  Change the id to
  73. 1024 before installing Technicolor.  (This type and ID
  74. can be changed by modification of the ‘WGFA’ resource.)
  75.  
  76. If you use PopUpFuncs 2.7, Technicolor is a one-button install
  77. (along with PopUpFuncs), thanks to Rich Siegel and the other
  78. folks at Bare Bones Software (http://www.barebones.com/).
  79.  
  80. Instructions for keyword and color customizing are in the
  81. “Customizing Technicolor” folder.
  82.  
  83. I recommend the installation of Macsbug 6.5.2 or an equivalent
  84. low-level debugger as well, as error messages will be delivered
  85. via DebugStr until I write code which uses the notification manager
  86. (in an effort to remain application-independent).
  87.  
  88. —————————————• Warnings
  89. "And suddenly the novice was enlightened."
  90.  
  91. This software is provided AS IS.  I can’t be held responsible if
  92. it crashes your Mac and you lose your hard drive as a result.
  93. Apple might be liable for selling you a Mac which causes you to
  94. lose hard drives in crashes. (Hmmm... But if that were so, the
  95. Unix industry would've died ten years ago, strangled by lawsuits,
  96. and Microsoft wouldn’t still be here either.  Never mind, you're
  97. on your own entirely.)
  98.  
  99. You are hereby warned that this software has received a total of
  100. five minutes testing on an Apple II+.  It also happens to have been
  101. coded in five minutes, so be doubly cautious.
  102.  
  103. —————————————• Version History
  104.  
  105. Version 0.9.1 (private release):
  106. * Updated keyword sets.
  107. * Keywords are no longer colorized in dialogs, which should
  108.  fix other possible misc problems as well.
  109.  
  110. Version 0.9:
  111. * Support for case insensitive keywords for Pascal, Dylan, et al
  112. * Coloring is more accurate WRT edge cases ...
  113. * Fixed the ResEdit 'kJai' template
  114. * Now coexists peacefully with PopUpFuncs and things of that nature
  115. * New keyword sets:
  116.         MPW Shell Script (files ending in "Worksheet", ".ss", ".ts")
  117.         Inform, the Infocom game language (files ending in ".inf")
  118.         
  119. * No doubt other misc stuff.
  120.  
  121. Version 0.8.1:
  122. * CodeWarrior’s linker is in the bad habit of deleting random
  123. resources in the destination file for no apparent reason.  So,
  124. here’s a resource file with the proper set of resources.
  125.  
  126. Version 0.8:
  127. * Multiple configurable keyword sets based on file dot extensions!
  128. * 68k support!
  129. * Includes the Rez files/project used to generate the resources
  130. * Compiled optimized now
  131. * Some speed optimizations
  132. * Fixed ResEdit template bug
  133.  
  134. Version 0.7:
  135. * Keywords and colors are now configurable via resources.
  136.   Still limited to a single global set of keywords.
  137. * Fixed all known cosmetic bugs.
  138. * No known non-cosmetic bugs in 0.5, so no non-cosmetic
  139.   fixes.
  140. * The optional colorized MPW icon now contains a set of
  141.   appropriate small icons.
  142.  
  143. Version 0.5:
  144. * First release.
  145.  
  146. —————————————• Limitations
  147. "Time is passing"
  148.  
  149. The default keyword set, used when Technicolor can’t match the
  150. current filename to a keyword set, is hardwired to C++.
  151.  
  152. In the current (3.4/3.4.1) MPW Shell, Technicolor is limited to
  153. the original 8 QuickDraw colors.  This shouldn't be a problem with
  154. BBEdit or other apps which use color windows.  This will be fixed.
  155.  
  156. Currently, MPW Technicolor can’t parse through tabs.  This will
  157. show up, for example, as a line "//scheme \t >is a language?<"
  158. where \t represents a tab and the text >between< is *not* hilited
  159. in red.  This can be fixed through the implementation of a cache
  160. scheme, but it’s a lower-priority fix, and if I do it, it will be
  161. the last thing I do.
  162.  
  163. Doesn’t parse "/* comment */"-style comments on a single line yet,
  164. this will appear soon.  (This is not entirely true, actually, you
  165. can set "/*" as a ColorTillEndOfLine-class keyword, but that won’t
  166. always do The Right Thing.)
  167.  
  168. Can’t parse comments which span multiple lines yet.  This may not
  169. be fixable.
  170.  
  171. Text won’t always be colored properly in the background after
  172. an update event.  I don’t think I can fix this from outside the
  173. Shell.
  174.